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NEWS FLASH: Trawlel Buys Back Cowwodore and Apple in the save day | 


See details inside. 
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Calendar of Events: 


Next meeting - Saturday, April 19, 1986 
Ambruster Schook - 7000 Greenway - Greenfield, WI 


Doors open at 2:00 PM 
BASIC Class and 16-bit SIG at 2:15 PM 


Business meeting at 3:30 PM 
Nominating committee report 


Demonstration at 4:00 PM 
ATARI WRITER PLUS 
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ATARI IN THE PRESS 


The future of ATARI may be up for grabs but... more publications 
ane featuring articles on ATARI machines. For example, MICRO 
CORUCOPIA la magazine formally dedicate to 8-bit single board 
computers) has an article entitled "Porting A 68000 Assembler To 
The Atari ST" in their April issue.  VALWORLD GAZETTE which 
originally address Epson computer owners is now featuring articles 
on the Atari ST. The current issue has two articles for ST owners, 
520ST vs 1040ST and THE FABULOUS ST. 


Samples of both magazines wikk be available at the meeting. 
(Continued on page 7) 


FROM THE DISK OF 


Dave Frazer 


BY GARY HOLAH 


WARNING! WARNING!!! WARNING!!! 

In last months column I told you about an offer for VIP Professional, a 
Lotus 123 clone, from a company called Gumball Express. It has come to my 
attention that the people who own VIP and the people who own Gumball 
(Shanner) are involved in a lawsuit with VIP claiming that Shanner is no 
longer permitted to sell their spredsheet. They also say that they WILL NOT 
honor the warranty of any program sold by Gumball. So take heed and buy 
wisely. If you’ve already ordered from them do not accept delivery on it. If 
you already have opened the package try contacting Gumball to return it. If 
that dosen’t work contact the California Attorney General’s office in 
Sacramento. We have been told that you could run into problems if you try to 
hook up a non-Atari RGB monitor to the ST’s. Atari is rumored to be readying 
a monitor that has both composit and RGB inputs so it will work on both the 
8-bit and 16-bit systems. 

COVER YOUR TRAKS 

Anybody out there with a Trak disk drive? Thinking about getting rid of 
it because it’s hard to find repairs? Well take note. Integrated Computer 
Resources at 247 N. Neltnor Blvd., Suite GIF in West Chicago, IL 60185 will 
repair and upgrade Trak drives, they can also supply cables for the AT-D2 
drives with the built-in printer port/buffer. For more info contact them at 
the above address or give them a call at (312) 231-6104. 

And if you’re one of those with a Percom, STS Computers at 1073 W. Broad 
St. in Falls Church, VA 22046 has a nationwide contract to repair these 
drives. They have also developed a new OS ROM for these drives. For more 
information contact them or call them at (703) 237-0558. 

WORK, WORK, WORK 

The ST’s have been getting a real workout lately. IQ Peripherals of 
Mountian View, CA is developing the ST into a low cost UNIX workstation. It 
will use UNIX System V from AT&T which will allow it to hook up to 
mainframes. The system to be introduced later this year will retain its 
ability to function as a standard Atari ST and will cost about half of what 
current stand alone workstations cost. Atari meanwhile is working on its own 
UNIX products. 

One west coast dealer has reported a large number of ST sales to 
business accounts that plan to use them as "smart" terminals. It really is 
like getting two for the price of one. 

REPORTS OF ITS DEATH ARE GREATLY EXAGGERATED!!! 

CP/M ain’t dead yet folks. But it shure is breathing a mite harder. 
There is a million plus CP/M machines out there, plus a bunch of ATR’s that 
could use some good software. Some of those machines are going on their 
second owners. And the prices on new unsold units are dropping. You can buy a 
Kaypro clone with 2-DSDD, 9" amber screen, Micropro software (Wordstar, 
ECT.), parallel & serial ports and built in speech synthsizer for only $525 
shipping included. And don’t think these are slow dogs either. Remember, the 
IBM PC is only two steps faster than dry concrete. There are still several 
companies developing software for these machines. Some are producing hardwa: 
add-ons for them too. One of them is Periphco of Santa Clara. They are 
offering an EPROM (chip) programer to user groups at special prices. This 
unit, the Programmer/4+ will program 2 to 16K ROM and EPROMS including CMOS 
types. It hooks up through the RS232 port and comes with software on disk in 
several formats. This completely built and tested unit costs $175 in lots of 
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SHHHH!!! MAYBE NO ONE WILL NOTICE 

Tandy (aka Radio Shack) had what they thought was a great new way to 
sell computers to the masses. The Door-to-door approach. Or as you 
Tupperware freaks call it the “home demonstration". This was supposed to move 
a lot of Color Computer II’s and eventually the Model 1000 into our homes. RS 
has decided to let someone else tackle this project and has quietly let its 
effort die. Tandy currently has (this might have ended) a promotion going 
where you can buy a Model 1200 (XT clone) and get a free Model 100 (laptop, 
just like Dave’s). Now either 1200 sales have slid off the edge or RS has a 
ton of 100’s to get rid of so’s they can push the newer 200 & 600. Still it’s 
not that bad of an offer if you need an XT clone and something to tote around 
with you. 


EVERYTHINGS DUCKY(SOMETIMES EVEN I WINCE) 

From Holmes & Duckworth, the producers of H&D Bbase for the ST’s comes 
the Journal of Micronomy (sure!). It’s a short newsletter type thing that 
gives tips and news about H&D Base and other programs from Chester and 
Oliver. Version “125" is now available. It offers some enhancements and 
corrections to preceding versions. What may they be, you ask? Well lest you 
think Chet & Ollie have been resting on their laurals, here are a few. 
Restructuring of mailing list command file 
New mail list program (with GEM interface) 

Auto-run feature 

Additional error trapping 

Correction of all program anomalies Cinconsistencies)((BUGS)) reported by 
users 

As a registered owner you are entitled to the anomaly corrections free 
of charge. These corrections which consist of about 20 lines of Command File 
code that you type in are available upon request. The other goodies will cost 
you a mere $5. Now thats pretty reasonable considering what some other places 
have charged for upgrades. They have also opened up a Tech Support phone 
service that is available from Ipm to 5pm (Pacific time) Monday through 
Friday at (209) 226-1485. You can also call their BBS, if you don’t mind the 
long distance charges, at (209)276-2037. It’s up from 1 to 7pm (Pacific time) 
on weekdays and 24hrs on weekends. These two madcap lads also have two new 
programs for the ST. The first is Toolbox which consists of five utlilty 
programs which include a disk file/sector editor, memory editor, deleted file 
recovery, directory print and fast format and copy routines. All this for 
$39.95. The other offering is H&D Forht, a Forth programming language selling 
for $49.95. You can order by phone at (800) 641-1441. Now if we could just 
get one of you ST types to writ a review of H&D for the newsletter, we could 
find out what this is all about. 

MAC ATTACK! MAC ATTACK! 

When the ST’s where first released everyone talked about porting 
programs from Apple’s Macintosh to the new Atari. Up until now it’s been all 
talk and no action. Well an old hand at fooling around with Atari computers 
is at it again. David Small (the name should ring a bell with the old timers) 
and a company called Data Pacific have announced a product called the Mac 
Cartridge (hold the onions please) that allows the 1040ST or a boosted 520 to 
run programs from the Macintosh. There are a couple of gotchya’s though. The 
first is pretty easy to solve, and that’s how to get the originals over to 
the ST. Just use a serial cable or modem. The biggest one involves the 
Macintosh 64K ROM chips that hold most of the computers user interface. The 
problem will be in getting Apple to license Data Pacific to make them. Apple 


is not going to help someone build a machine that can do EVERYTHING theirs 
can and more! You could buy the cart from DP and buy the ROM’s from an Apple 
Jealer and assemble it yourself. But how long do you think the supply would 
lust? Me "too. The first showing of the cart will be at the West Coast 
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Party Quiz 


Question disk 
Haker 


by Roy Duvall 


Before Xmas I purchased Party Quiz (it 
was and still is on sale at Computer 
Software Center.) This is an enjoyable and 
well done game system. But I wanted to 
tailor my own special subject trick 
questions. So I dug through the clubs 
archives of other group newsletters and 
found a program to make PQ Question disks 
in Computer Squad News ( an Illinios 
group) After long hours of entry (the 
listing wasn't quite totally readable.) I 
started entering my questions. The program 
had a few bugs, as well as, typos. After 
many more hours I discovered either there 
must be 2 versions of PQ or the program was 
seriously flawed. They separated every 
item with an ESC (27) and my PQ Disk 
separated items with returns (155). 
Eventually I decided to write another 
version which (hopefully) resolved the bugs 
and added editing features. I chose BASIC 
although I prefer BASIC XL, due to its 
availability. 


You must have an original PQ Question 
disk to copy the 1st 9 sectors to your disk 
then you have 690+ sectors for your 
questions. Each sector contains 2 question 
/ answer sets (64 characters Max). Sectors 
10 thru 540 are for multiple choice 
questions - Where the first answer is the 
correct choice. Sectors 540 thru 707 are 
for True False questions. You must enter a 
correct answer if the question is false. 
The edit facility is to edit a question 
that already exists ( my typo's made this 
facility a mandatory) The program should 
be available on the BBS or through the club 
library soon. The deadline for the 
newsletter limited the testing time, so if 
you find any new bugs give me a holler. 
Happy Q's - Roy. 


For MILATARI March 1256 
A REM PARTY QUIZ QUESTIOM DESK MAKER 


2 REM VERSIOM 1 BY ROY JOHNSON & STAN 
SUBECK 

3 REM VERSION 2 BY ROY DUVALL 

4 REM THIS PROGRAM IS IM THE PUBLIC DO 
MATN 

20 DIM MULSTCLZ293, BSC6AI ,05 C643 ,C5 C64), 
HS C13 ,AS £1293 ,DS (1157) 

ZO MULS C19 =CHRS 10) : NULS 1129) =CHRS COI: M 
ULS (23) =MULS: ASMULS 

1060 POKE 752,41 


400 GRAPHICS 16:7 H$6:7 167" PLIREAS QUI 
Z DISK":7? MO: 7? 163" MAKER"":7 HG: 
? H6:7 N6:7 HE;" BY roy & stan" 


500 OPEN H2,4,0,"K:"" 

890 DS CAI -—CHRS (02 :DS CLASZI=~CHRS CGI IDSC 
23 =DS:P—APREIDSI :A-APRCASI 

900 POKE 1536,104:POKE 1537,3Z:POKE 15 
38,853:POKE 1539,22868:POKE 1546,96 

950 FOR H=1 TO 50608:MEXT H 

18900 GRAPHICS O:SETCOLOR 2,7,1:S5SETCOLO 
R 4,2,4:POSITION 15,2:7 "MAIN MENU" 
1100 POSITION 11,6:? "H-IMIT NEW DISK. 
.. 

1200 POSITION 11,8:7 "IX-WRITE QUESTION 
t- Wp! 

4210 POSITION 11,10:7 "KJ-EXIT PROGRAM. 
.. 

1360 POKE 752,1: POSITIOM 16,13:7 “IZH 
27"; :GET #2,R 

4350 IF R=88 THEN POKE 752,1:7 "KR": END 


1400 IF R=73 OR R=-105 THEN 1700 

1500 GOTO 2000 

16060 2 :7 :? "ERROR LLLLD":FOR I=4 TO 1 
780: MEXT I:GOTO 100 

17689 TRAP 1666 

1800 2 "Qo": 7 :7 "PUT BLANK DISK IN DRI 
VE #1 FOR':7 “BODES. HIT RETURN Y 
HEN READY .'': :GET 8#2,R:IF R<>155 THEN 1 
BOB 

1900 KHIO 254,H1,0,0,"D1:" 

2000 2 "R":R=8:7? "R":POSITION 15,2:7 ” 
WRITE MENU" 

2166 POSITION 11,6:7 "E-START A NEH DI 


5K." 

2200 POSITION 14,86:7 "®- CONTINUE A DI 
SK" 

2300 POSITIOM 11,10:7 "0 TOGGLE SHOW 
CURENT." 

2350 POSITION 11,12:7 "G- EDIT A QUEST 
rom." 

23809 POSITION 10,16:7 "“GEIS-ExXIT TO MAT 
N MEMU." 

2400 POSITION 14,12:7? "S/C¿T/E 7*"3:3GET 
HZ, R 


Z5B0 IF R=27 THEM 1666 

2559 IF R=84 THEN 7566 

2569 IF R=69 THEM 68666 

2600 IF R=33 OR R=115 THEM 2500 

2700 GOTO 4266 

280068 2 "pg" 

22080 TRAP 1680 

3008 7 :?7 :? “INSERT ORIGINAL QUESTE 
DESK. : 7 “HET RETUNNM.'"; :GET H2,R 

3100 PAKE 769,1: POKE 770,82:GOSUB 3206 
¿GOTO 3290 

32AD SUM-ASRO 

3300 SUM SHUMA 1 

ZADO POME 779, TMI COUN 25G? : POKE 7789, IM 
TC KSUMS ZSO- ILMI CSUM/4 2563 INV SoD 


remaining = ";¿RE:GET H2,0 
16616 IF @=27 THEM RETURN 


10820 IF Q=126 THEN GOSUB 16910:Q0=>232:G 


OSUB 16259:GOTO 10500 


106530 GOSUB 16260:GOSUB 16956:GOSUB 10 


230: RETURN 


10650 NO=G6:POSITION 2,260:7 "Is this co 
Prect £Y/M23":GET #2,R:EIF R=89 OR R=-171 


THEM RETURN 
105609 NO-=1:RETURM 
1629200 LINE=STL:COL=2:RETURN 
10210 H=H-1 : RE=RE+F1:IF WO THEN H-8 
16915 IF RE>63 THEM RE=6Z3 


16916 COL=COL-1:1IF COL<Z2 THEM COL=39:L 
INELIME-1:IF LINEX<STL THEN GOTO 16096080 


10226 RETURN 


10930 COL=COL+1:IF COL>39 THEM LINE=LI 


NE+F1:COL=Z 
16946 RETURN 


16250 POSITION COL,LINE:? CHRS€Q);:RET 
16966 RE=RE-4 : WH=H+1 : BS 2) =CHRS$ CQ) :RETU 


16976 B-=LENCBS+1: IF B>=64 THEN RETURN 


16975 GBS €BI=—MLULS : RETURN 
11060906 REM SHOM CURRENT FIRST 
11616 CM=62:GOSUB 702060:? "R 
contents of sector "; SUM 
11626 7 AS:7 "44Hit any key to continu 
e':GET #2,R:RETURM 

1200606 REM MULTIPLE CHOICE QUESTIONS 
12010 IF SHONME THEN GOSUB 11000 

12028 AS=NULS:AB=0 

12630 GOSUB 12500:GOSUB 1060400: 1IF 0Q-27 
THEN 26060 

12040 AB=1:GOSUB 12566:GOSUB 10400:IF 
Q=27 THEM 2720006 

12050 GOSUB 7000 

1206606 SUM=SUM+1:GOTO 172000 

125009 REM ASK MULTI QUESTION 

12510 BS-=MULS:RE=63:H-=06:S5TL=6 

12520 7 "kR Multiple Choice Questio 
ns'':GOSUB 10450 

12530 GOSUB 169200 


12546 GOSUB 1068580606: IF Q=27 THEN RETURN 
12580 IF @=155 THEN 12666 

12596 IF RE<S THEN GOSUB 10430:GOTO 12 
566 

12525 GOTO 12540 

12606 REM GET AMSHERS 

12616 FOR A1=1 TO 4:5TL-=3+(A41*%23 : GOSUB 
16900 

12626 POSITION COL,LINE:? "Enter answe 
r ";3Aa1;:5TL=STL+1:GOSUB 16966 

12625 GOSUB 16500: 1I1F @Q=27 THEM RETURN 
12636 IF 00-155 THEM NEXT AIi:GOTO 127066 
12646 IF RE“¢1 THEN GOSUB 16430:GOTO 12 
666 

12650 GOTO 12625 

127066 GOSUB 105508: IF MO THEM 120666 
12710 GOSUB 169668:GOSUB 16970: RETIURN 


Current 


Mio Os) VE 


PAGE 6 


10506 TRAP 165806: POSITIOM 10,4:7? "Char 


The RUMOR MILL 
by Joe Waters 


The IBM emulator for the ST: will not have the 8087 chip 
included, but will have 520K, 8080 chip, disk drive port, 100% 
MS-DOS compatibility, and $199 price. The prototype will be shown 
at the Hannover Fair in West Germany this month. I understand 
that the emulator does run LOTUS (and SYMPHONY). The "blitter" 
chip: not 500 times faster, only 100 times faster and the chip IS 
NOT a math co-processor. There have been some rumors that the new 
STs would include a socket for this new chip. Not so. To install 
it, you will have to remove the 68000, install a daughter board, 
and put the blitter chip and the 68000 on this board. 


While on the subject of emulators ... what's the most popular 
computer(and software) in the elementary and secondary school 
systems? Apple II. Guess what computer company will be releasing 
an Apple II emulator in two months for a machine called the "ST". 
You got it! 


ST LOGO replaces ATARI LOGO. Atari is shipping an expanded and 
revised version of LOGO with the new STs that is auch faster and 
includes six new primitives (CALL, SOUND, FULLSCREEN, SYSFACTS, 
«WDEPOSIT, and .WEXAMINE). 


Want a Laser Printer? As some of you know, laser printers are all 
the rage. Quick, excellent copy, but at a price. Cheapest 
available at the moment is just a hair under $2,000. But, be 
patient. Look for an Atari laser printer this fall, equivalent to 
the Canon Laser, priced at $1,200, Enhancements, which will come 
later, will give this printer a 400 dpi resolution and allow it 
to compete directly with the Apple Laserwriter. 


Software News. The quantity and quality of ST software continues 
its steady climb. VIP has, indeed, shipped their VIP 
Professional, a Lotus 1-2-3 clone. The first disks on the street 
had a number of bugs in them and the memory constraint was quite 
severe. However, the arrival of the TOS ROM chips will take care 
of memory constraints and VIP has been fixing the bugs and 
releasing “patches” which now make this an excellent program. 


Those of you waiting for a strong database program now have H&D 
Base ($100) available. This dBASE II clone gives the ST a strong 
andversatile database management package. Within two hours of 
having opened the package, I had transferred dozens of files 
totaling several thousand records from dBASE III on an IBM to H&D 
Base on an ST. This product too has some early bugs, but they are 
being corrected and Mirage anticipates providing a continuing 
series of enhancements to the package. = 


Mirage will have to keep working on enhancements because 
Versasoft Corp will soon (April 1) be releasing their dBMAN 
database management product. This system is (90-95%) dBASE 11 and 
dBASE 111 compatible and has a whole host of functions built into 
the language. Retail price will be $149 (with a 30-day money-back 
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John Dvorak'4 column "INSIDE TRACK" this week discuss the next generation of machine from 
ATARI and the other guy. Both machines are build designed around Motorola's 68020 CPU 
chip. The other guy's machine [code named the Ranger) comes with 512K or more and a 1,024 
by 780 pixel superhigh resolution display. Gentleman Jack will do a Little better. ATARI 
is working on a system with 1,024 by 1,024 píxel display. 


From the OnRine Press oer « tor cciccecccesesccseses 
ELECTRONIC ARTS PLANS TO RELEASE 8-BIT SOFTWARE 
ANTIC PUBLISHING INC.,COPYRIGHT 1986. REPRINTED BY PERMISSION. 


Electronic Arts software company president Trip Hawkins has written the last Letter he 
will ever need to send to Antic Magazine. 


"The response of your readers to Antic editorials is growing,” wrote Hawkins. "We have 
received quite a few Letters." Quite a few indeed. In a letter-writing campaign 
initiated over nine months ago with a May, 1985 Antic editorial, not only Antic readers 
but the entire Atari community begged EA and other major software publishers to release 
more software for the &-bit Atari computers. 


EA promises to nelease Adventure Construction Set, Heart of Africa, Mail Order 
Monsters, Marble Madness, Racing Destruction Set, Skyfox, Software Golden Oldies 
(Software Country), and Ultima IV (Origin Systems) for the Atari XL/XE 8-bit Line of 
computers in 1986. 


"We hope to see at retail the kind of response we have seen in our maikbox!" Hawkins 
says in conclusion. 


BRODERBUND STILL GROWING 


The medía broadky prockaimed that 1985 was a "dismal" year for the personal computer 
industry. Broderbund Software proved otherwise.  Bolstered by several top selling home 
productivity and educational packages, spearheaded by the phenomenonal bestseller, Print 
Shop, Broderbund doubled their sales to $20 million during 1985. 


The December issue 04 Inc. magazine ranked Broderbund as the 13th fastest-growing 
privately held company in the United States. Microcomputer software distributors First 
Software and Softsel International also experienced rapid growth during 1985. 


ATARI VS. THE WORLD 


Atari Corp. has been sued again. This time for $55.2 million by an (unnamed) Japanese 
printer maker that claims Atari reneged on a contract to buy 500,000 printers. 


RUMOR HUMOR 


This satirical product announcement by Albert Lew of ABACUS, was found recently in the 
San Francisco-anea users group's newsletter: 


"Did you hear about the new $10 EPROM burner coming from Atari? Stick some 128K EPROMS 
in the blue plastic stots, and pop into the toaster oven. The docs recommend that you 
think hard about what you want burned, (Commodore, Apple, and IBM are suggested topics) 
and pray. 16 you are agnostic, you are requested to send more money to Atari until you 
get reasonable results." 
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Empty Communications 
Or What is a null modem? 
By Dovid Frazer 


Last Saturday I overheard someone ask 
what a "null modem" was. And how can it 
be used to have my 800 talk to my ST? 


I've heard this question several other 
times and unfortunately the term "null 
modem" is not defined in any of the 
manuals on communications. Actually, 
null modem is a fancy name for the cable 
used to connect two pieces of computer 
equipment together. That's the simplest 
part. Let's look at a semi-technical 
explanation. 


In basic computer terms, we have two 
types of equipment: Data Terminal 
Equipment which consists) of actual 
computers, terminals, printers and the 
like; and Data Communication Equipment, 
which is primarily modems. 


In computerese, these are referred to as 
DTE and DCE. In the beginning of 
computer history, all computer equipment 
was hard wired together and none of this 
nonsense mattered. Then came the days of 
terminals and connections via the 
telephone system, which usually meant Ma 
Bell. 


You old-time communicators might recall 
the days when the only supplier of 
modems was Ma Bell (for all practical 
purposes). A modem, or DCE, is used to 
send computer data over telephone lines; 
it's basically a computer telephone. 
Just as two voice telephones connect the 
mouthpieces of one telephone to the ear- 
piece of the other via the phone system; 
two modems 


connect the data-send 


circuits of one piece of computer 
equipment to the data-receive circuits 


of the other. 


The traditional data communications 
setup is illustrated in Figure l. The 
real purpose of the DCEs (modems) and 
the phone system was to: 

l. Connect the two DTEs over long 
distance via the telephone system. 

2. Connect the send side of one side to 


the receive of ,the qt her. 
telephone 
DE =< BOE 2270 SEKEG DOF cc DNE 
system 
Figure l. 


This is the basic method still in use 
today, but now we can buy modems and 
telephone service from any suppliers. 


send >>> <<< receive 
DTE == DCE " telephone” sys DCE == DTE 
receive >>> <<< send 
Figure 2 


There was one thing that wasn't so good 
about the traditional setup, though. 
Suppose you had two pieces of DTE in the 
same room? Under the traditional setup, 
in order to connect two DTEs, you needed 
the DCEs and the phone system because if 
you connect two DTEs directly, the send 
of the first DTE is connected to the 
send of the second. 


send — amama send 
DTE DTE 


receive _s receive 
Figure 3 


Let's expand the picture and show the 
cornet] deta? pathan in Figure 12. En 
Figure 3, I've removed the modems (DCEs) 
and the telephone system. Note now that 
our connection doesn't work because 
we've connected the mouth piece of my 
phone (send) to the mouth piece of 
yours, instead of the ear piece! 


That's it, the setup will not work with 
a "straight" cable. But if you bùird“ a 
special cable that crosses the send and 
receive signals as required by two DIEs, 
then you can eliminate the need for the 
DCE and the phone system. You need to 
build a cable which makes the 
connections described in Figure 4. 


send send 


DTE he rd DTE 
receive receive 


Figure 4 
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Permission to reprint or excerpt is granted 
only if the following line appears at the top 
of the article: 

ANTIC PUBLISHING INC., 
REPRINTED BY PERMISSION. 
Professional GEM by Tim Oren 
THE DIALOG HANDLER 
11/7/85 


COPYRIGHT 1985. 


This issue of ST PRO GEM begins an 
exploration of ST GEM’s dialog handler. I 
will discuss basic system calls for 
presenting the dialog, and then continue with 
techniques for initializing and reading 
on/off button and "radio” button objects. We 
will also take some short side-trips into the 
operation of the GEM Resource Construction 
Set to assist you in building these dialogs. 


There are a number of short C routines 
which accompany this column. These are stored 
as file GEMCL3.XMO in DL 5 on SIG*ATARI. 


Before reading this column, you should visit 
SIG*ATARI (go pcs-132) and download this 
file. 


DEFINING TERMS 
A dialog box is an "interactive fora” in 


which the user may enter text and indicate 
selections by pointing with the mouse. 
Dialogs in GEM are "modal”, that is, when a 
dialog is activated other screen functions 
such as menus and window controls are 


suspended until the dialog is completed. 

In most cases, the visual structure of a 
GEM dialog is specified within your 
application's resource file. The GEM 
Resource Construction Set (RCS) is used to 
build a picture of the dialog. 

Uhen the RCS writes out a resource, it 
converts that picture into a tree of GEM 
drawing objects and stores this data 
structure within the resource. Before your 
application can display the dialog, it must 
load this resource file and find the address 
of the tree which defines the dialog. 

To load a resource, the AES checks its 
size and allocates memory for the load. It 
then reads in the resource, adjusting 
internal pointers to reflect the load 
address. Finally, the object sizes stored in 
the resource are converted from characters to 
pixels using the system font size. 

(A note for those with Macintosh 
experience: Although Mac and GEM resources 
share a name, there are fundamental 
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differences which can be misleading. A Mac 
resource is a fork within a file; a GEM 
resource is a TOS file by itself. Mac 
resources may be paged in and out of memory; 
GEM resources are monolithic. GEM resources 
are internally tree structured; Mac resources 
are not. Finally, Mac resources include font 
information, while ST GEM does this with font 
loading at the VDI level.) 

The resource load is done with the GEM 
AES call: 

ok = rerc_load(ADDR("MYAPP.RSC”)); 

"MYAPP” should be replaced with the name 
of your program. Resources conventionally 
have the same primary name as their 
application, with the RSC extent name inatead 


of PRG. The ok flag ceturned by rarc_load 
will be FALSE is anything went wrong during 
the load. 

The most common causes of failure are 


the resource not being in the application’s 
subdirectory, or lack of sufficient memory 
for GEM to allocate space for the resource. 
If this happens, you must terminate the 
program immediately. 

Once you have loaded the resource, you 
find the address of a dialog’s object tree 
with: 

rarc_gaddr(R_TREE, MYDIALOG, atree); 
Tree is a 32-bit variable which will receive 
the address of the root node of the tree. 

The mnemonic MYDIALOG should be replaced 
with the name you gave your dialog when 
defining it in the RCS. At the same time 


that it writes the resource, RCS generates a 
corresponding .H file containing tree and 
object names. In order to use these 
mnemonics within your program, you must 
include the name file in your compile: 
include "MYAPP.H” 
BUG ALERT! 

Uhen using the DRI/Alcyon C compiler, .H 
files must be in the compiler’s home 
directory or they will not be found. This is 


especially annoying using a two floppy drive 
ST development system. The only way around 


this is to explicitly reference an alternate 
disk in the include, for inatance: 
"B:MYAPP.H” 


Now that the address of the dialog tree 
has been found, you are ready to display it. 
The standard (and minimal) sequence for doing 
so is given in routine hndl dial() in the 
download. We will now walk through each step 
in this procedure. 
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The form_center call establishes the 
location of the dialog on the acreen. Dialog 
trees generated by the RCS have an undefined 
origin (upper-left corner). 

Form center computes the upper-left 
location necessary to center the dialog on 
the acreen, and inserts it into the OB X and 
OB_Y fielda of the ROOT object of the tree. 
It also computes the screen rectangle which 
the dialog will occupy on acreen and writes 
ite pixel coordinates into variables xdial, 
ydial, wdial, and hdial. 

There ia one peculiarity of form center 
which occasionally causes trouble. Normally 
the rectangle returned in xdial, etc., la 
exactly the same size as the basic dialog 
box. 

However, when the OUTLINED enhancement 
has been apecified for the box, form_center 
adda a three pixel margin to the rectangle 
returned. This causes the screen area under 
the outline to be correctly redrawn later 
- (eee below). Note that OUTLINED ia part of 
the standard dialog box in the RCS. Other 
enhancements, such as SHADOUED or "outside” 
borders are NOT handled in this fashion, and 
you must compensate for them in your code. 

å The next part of the sequence is a 
form dial call with a zero parameter. This 
reserves the screen for the dialog action 
about to occur. Note that the C binding given 
for form dial in the DRI documents is in 
error: there are nine parameters, not five. 
The first set of xywh arguments la actually 
used with form_dial calle 1 and 2 only, but 
place holders must be supplied in all cases. 


The succeeding form dial call (parameter 
one) animates a "zoom box” on the screen 
which moves and grows from the first screen 
rectangle given to the second rectangle, 
where the dialog will be displayed. 


The use of this call isa entirely 


optional. In choosing whether to use it or 
not, you should consider whether the origin 
of the "zoom" la relevant to the operation. 


For instance, a zoom from the menu bar is 
relatively meaningless, while a zoom from an 
object about to be edited in the dialog 
provides visual feedback to the user, shoving 
whether the correct object was chogen. 

If the origin is not relevant, then the 
zoom ia just a time-waster. If you decide to 
include these effects, consider a 
"preferences” option in your app which will 


allow the experienced and jaded user to turn 
them off in the interests of speed. 

The objc_draw call actually displays the 
dialog on the screen. Note that the address 


off the tree, the beginning drawing object, 
and the drawing depth are passed as 
argumenta, as well as the rectangle allotted 


for the dialog. 

In general, dialogs (and parts of 
dialoga) are ALWAYS drawn beginning at the 
ROOT (object zero). When you want to draw 
only a portion of the dialog, adjust the 
clipping rectangle, but not the object 
number. This enaurea that the background of 
the dialog is always drawn correctly. 

The objc_xywh() utility in the download 
can be- used to find the clipping rectangle 
for any object within a dialog, though you 
may have to allow an extra margin is you have 
used shadows, outlines, or outside borders 
with the object. 

Calling form_do transfers control to the 
AES, which animatea the dialog for user 
interaction. The address of the dialog tree 
is passed as a parameter. The second 
paranter is the number of the editable object 
at which the text cursor will first be 
positioned. If you have no text fields, pass 
a zero. Note that again the DRI documents 
are in error: passing a -1 default may crash 
the system. Also be careful that the default 
which you specify is actually a text field; 
no error checking is performed. 

The form do call returns the number of 
the object on which the clicked to terminate 
the dialog. Usually this is a button type 
object with the EXIT and SELECTABLE 
attributes set. Setting the DEFAULT 
attribute as well will cause an exit on that 
object is a carriage return is struck while 
in the dialog. 

If the top bit of the return is set, it 
indicates that the exit object had the 
TOUCHEXIT attribute and was selected with a 
double-click. Since very few dialogs use 
this combination, the sample code simply 
masks off the top bit. 

The next form dial call 
"zoom box”, moving it from the 
location back to the given x,y,w,h. 
cautions apply here as above. 

The final form dial call tells GEM that 
the dialog is complete, and that the screen 
area occupied by the dialog is now considered 
"dirty” and needs to be redrawn. Using the 


reverses the 
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methods described in our last column, GEM 
then senda redraws to all windows which were 
overlaid, and does any necessary redrawing of 
the menu or desktop itself. 

There ig one notable "feature” of 
form_dial(3): It always redraws an area 
which is two pixels wider and higher than 
your request! This was probably included to 
make eure that drop-shadows were cleaned up, 
and ia usually innocuous. 

A HANDY TRICK 

Use of the form dial(3) call is not 
limited to dialogs. You can use it to force 
the system to redraw any part of the screen. 
The advantage of this method is that the 
redraw area need not lie entirely within a 
window, as was necessary with the send redraw 


method detailed in the last column. A 
disadvantage ie that thia method is somewhat 
slower, since the AES has to decide who gets 


the redraws. 

CLEAN UP 
step, you need to clear the 
SELECTED flag in the object which wae 
clicked. If you do not do this, the object 
will be drawn inverted the next time you call 
the dialog. You could clear the flag with 


As a last 


the GEM objc_change call, but it is 
inefficient since you do not need to redraw 
the object. 

Instead, use the desel_obj() code in the 
download, which modifies the object's 
OB STATE field directly. Assuming that 
ret_obj contains the exit object returned by 


hndl_dial, the call: 
desel obj(tree, ret_obj); 
will do the trick. 


RECAP 
The basic dialog handling method I have 
described contains three ateps: 
initialization (rarc_gaddr), dialog 
presentation (hndl_ dial), and cleanup 


(desel obj). 

Ae we build more advanced dialogs, these 
same basic steps will be performed, but they 
will grow more complex. The initialization 
will include setting up proper object text 
and states, and the cleanup phase will also 
-interrogate the final states of objects to 
find out what the user did. 

BUTTON, BUTTON 

The simple dialogs described above 
contain only exit buttone as active objects. 
As such, they are little more than glorified 
alert boxes. 


Ve will now increase the complexity a 
little by considering non-exit buttons. 

These are constructed by setting the 
SELECTABLE attribute on a button object. At 
run-time, such an object will toggle its 
state between selected (highlighted) and 
non-selected whenever the user clicks on it. 
(You can set the SELECTABLE attribute of 
other types of objects and use them instead 
of actual buttons, but be sure that the user 
will be able to figure out what you intend!) 


Having non-exit buttons forces us to 
consider the problem of initializing thea 
before the dialog, and interrogating and 
resetting them afterward. 

Since a button is a toggle, it is 
usually associated with a flag variable in 
the program. As part of the initialization, 
you should test the flag variable, and if 
true call: 

sel_obj(tree, BINOBJ); 

which will cause the button to appear 
highlighted when the dialog is first drawn. 
Sel_obj() is in the download. BTNOBJ is 
replaced with the name you gave your button 
when you defined it in the RCS. Since the 
button starts out deselected, you don’t have 
to do anything if your flag variable is 
false. 

After the dialog has completed, you need 
to check the object's state. The selectp() 
utility does so by masking the OB STATE 
field. You can simply assign the result of 
this test to your flag variable, but be sure 
that the dialog was exited with an OK button, 
not with a CANCEL! Again, remember to clean 
up the button with desel_obj(). (It's often 
easiest to deselect all buttons just before 
you leave the dialog routine, regardless of 
the final dialog state.) 

WHO'S GOT THE BUTTON? 

Another common use of buttons in a 
dialog is to select one of a set of possible 
options. In GEM, such objects are called 
radio buttons. This term recalls automobile 
radio tuners where pushing in one button pops 
out any others. In like fashion, selecting 
any one of a set of radio buttons 
automatically deselecta all of the others. 

To use the radio button feature, you 


must do some careful work with the Resource 
Construction Set. 
First, each member of a set of radio 


buttons must be children of the same parent 
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object within the object tree. To create this 
structure, put a hollow box type object in 
the dialog, make it big enough to hold all of 
the buttona, and then put the buttona into 
the box one at a time. 

By nesting the buttone within the box 
object, you force them to be ita children. 
Each of the buttons muat have both the 
SELECTABLE and RADIO BUTTON attributes set. 
When you are done, you may make the 
containing box invisible by setting ite 
border to zero, but do not FLATTEN it! 

Since each radio button represents a 
different option, you muat usually assign a 
name to each object. When initializing the 
dialog, you must check which option ia 
currently set, and turn on the corresponding 
button only. A chain of if-then-else 
structures assures that only one button will 
be selected. 

At the conclusion of the dialog, you 
must check each button with selectp() and 
make the appropriate adjustments to internal 
variables. Again, an if-then-else chain is 
appropriate since only one button may be 
selected. Either deselect the chosen button 
within this chain or do them all at the end. 


There la one common use of radio buttons 
in which you may short-cut this procedure. If 
the buttons each represent one possible value 
of a numeric variable, for instance, a set of 
selector buttons representing colors from 
zero to seven, then you can compute the 
initial object directly. 
In order for this technique to work, you 
use a special capability of the RCS. 
Insert the object corresponding to a zero 
value at the top (or left) of your array of 
buttona, then put the "one” button below (or 
right) of it, and so on. 

When the buttons are complete, the SORT 
operation is used to guarantee that the 
top/left object is in fact the first child of 
the parent box with the othera following in 
order. Due to the details of object tree 
structure (to be discussed in the next 
column), this will guarantee 
objects are contiguous in the resource. 

If you assign a name (say BUTTON1) to 
the first button, then you can initialize the 
correct button with the call: 

sel obj(tree, BUTTON1 + field); 


uhara fiala la tha varlahla af latanant+ 


must 


that these? jc_xywhítree, obj, p? 


scan the radio buttons to compute the new 
value for the underlying variable. The 
encode() procedure in the download will do 
thie. As always, remember to deselect the 
buttons at the end. You can use offsets or 
multipliers if your variable’s values don't 
start with zero or increment by one. If the 
values are irregular you may be able to use a 
lookup table, at the cost of additional code. 


COMING UP NEXT 
In the next column, I will discuss the 
internal structure of object treea. Then 
we'll use that knowledge to build a plece of 
code which will "walk” an entire tree and 
apply a function to each object. We'll apply 


this code to do all of the button deselecta 
with a single call! I'll also look at 
handling editable text fields and discussa 
some ways to alter a dialog's appearance at 
run-time. 
DISPELL GREMLINS 

An editing error caused an omission in 

the first installment of ST PRO GEM. The 


window components RTARROU and DNARROW should 
have been listed along with HSLIDE as the 
horizontal equivalents of the vertical slider 
components which were discussed. 


Basic Dialog Handler <<<<<<<<<< 


WORD 
hndl_dialttree, def, X, Y, W, h?) 
LONG tree; 
WORD def; 
WORD X» Y» Wy, hy 
í 
WORD xdial, ydial, wdial, hdial, exitobj; 
form_center (tree, &xdial, &ydial, %wdial, &hdial); 
form_dial(0, x, yy W, h, xdial, ydial, wdial, hdial); 


form_dial(1, x, Y, W, h, xdial, ydial, wdial, hdial); 


objc_draw(tree, ROOT, MAX_DEPTH, xdial, ydial, wdial, hdial) 


exitobj = form_do(tree, def) & Ox7FFF; 

form_dial(2, x, Y, W, h, xdial, ydial, wdial, hdial); 
form_dial(3, xX, Yy y h, xdial, ydial, wdial, hdial); 
return (exitobj); 


>>>>>>>>> Object rectangle utility <<<<<<<<<<<<<<<<<<< 


VOID $ 
/* get x,y,w,h for specified 


LONG 


tree; 


WORD obj; 

GFECT tp; 

ob jc_offset(tree, obj, &p->g_x, &P—>G_y); 
p-.9_w = LWGETC(OB_WIDTH! bj); 

p—-g_h = LWGEET(OB_HEIGHT ‘ob )) 5 
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ZOOMRACKS by Quickview Systems 
reviewed by R Duvall 


So what is it? The promo that accompanied 
this package says its 

a project organizer, 

a data base, 

a card file, 

a word processor. 
It does contain most of the required 
features of the above but I would classify 
Zoomracks as a filing system. The name 
comes from the metaphor of a rack system of 
timecards and the zoom feature of a movie 
camera. You can view the top line of card 
in a rack (20 at a time) or 20 lines of an 
individual card. Through the facility 
called smart zooms, you can view multiple 
racks at one time ( 9 max ). This is 
accomplished through removing the vowels and 
as many constants as necessary to fit the 
screen. 


Each card (quickcard) in the file (zoom 
rack) contains fields (fieldscrolls). Each 
field is free format and can be up to 250 
lines of 80 characters in length. You can 
sort racks on any field in the card. You 
can merge racks to create form letters. You 
can reformat racks to create mailing labels 
or other special purpose reports. You can 
add or delete or modify or change location 


of any field in a card. You can create 
macros to reduce repetitive command 
sequences. You can print out cards or 
racks. You can cut and paste cards from 


different or the same rack. There are a 
number of features that aid you in 
navigating in and between both fields and 
racks. And there are help dialogs to assist 
you if you should get lost. 


The program looks as if it were written in 
Forth (if that really matters) and has many 
nice features. There is a version for the 
IBM PC, as well as, for the Atari 520ST. The 
program does not use any GEM functions 
except for the mouse interface. All windows, 
dialogs etc. are accomplished through text 
screen manipulation. Although this 
application seems to be an excellent design 
fit for GEM it ignores all the built in 
routines. 


Zoomracks is designed to contain few 
limitations but in doing so eliminates a few 
of the niceties found in other database 
systems. Such as, Data validation routines, 
because all fields are free format anyth! 
is valid. Just because you label a field 
DATE doesn't limit it contents. The data 
may contain the Gettysburg Address. Also 
the data entry facility is not very 
appealing, mostly due to the free format 
capability. There is no facility to compute 
or mathematically manipulate fields. There 
are no print formatting functions in this 
version. And there is no documentation on 
converting or porting data from other data 
bases (if it is possible). 


I am puzzled as to whether this is a so-so 
or a good or a great product. I have not 


encountered any major software problems. 
Still, I have not found a good personal 
application for the product. It is 
different and in being so I wonder if that 
is why I'm not ecstatic about it. Zoomracks 
certainly contains some powerful features 


but I may be to (un)sophisticated for it? I 
am also disturbed thatitignored the 
capabilities of GEM and duplicated them at a 
cost of memory and speed. This could well 
be the general purpose filler of the future 
but... I will attempt to demo Zoomracks at 
a future ST SIG meeting and maybe you can 
help me decide. There is a contest for the 
best Zoomracks application : 1st prize is an 
Atari hard disk, 2nd a color monitor or $200 
3rd prize $100. Entries must be postmarked 
by June 30, 1986. Call me for details. -Roy 
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ALERT - ALERT - ALERT - ALERT 


This message comes from the TORONTO ATARI 
FEDERATION. 


issue of Phoenix, a fix for 


This fix came 


In the March 
the TOS ROM noise was given. 

store and, as it 
"fix" could damage 


local turns out, 
In fact the 


machine. 


from a 
is wrong. 
the 


the ST 
issue of 


proceed to install 


in the March 


Please do not 
"Fix" as outlined 
PHOENIX. 
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69 CENT DISKS ARE HERE! 


High Quality, 5-1/4", Single Sided (punched for two sided use), 
Double Density, complete with hub rings, write protect labels and 
Tyvek sleeves. 


| 
10 Disks... $6.90 
100 Disks... $69.00 | | 


COMPUTER SOFTWARE CENTER 
9805 W. Oklahoma Ave., Milwaukee 


(Two blocks East of interstate 894) 


Tues.-Fri. 12-8, Sat. 12-5 (414) 543-5123 


THERE'S MORE IN STORE FOR YOU AT 98TH & OKLAHOMA 


